Disabled

Boolean

false

Purpose

The Disabled parameter specifies how a fault in executing code is handled. If the Disabled parameter is set to true, the fault is passed to the system default handler (for example, to Windows error reporting). If the Disabled parameter is set to false, the process is terminated after taking a process dump, where possible.

A JADE exception can be raised instead of terminating the process. This option is available for a function in a third‑party DLL where any fault that occurred would never imperil the integrity of the executing process (for example, by corrupting memory or data).

To raise a JADE exception for a function instead of terminating the process, set the Disabled parameter to false and specify an action parameter in the following format.

on_library-name_function-name_Fault = action

The valid values for the action value are JomExceptionWithDump or JomException. For example, to raise a JADE exception when a fault occurs in the encryptdata function in the cryptolib library, specify the following.

on_cryptolib_encryptdata_Fault = JomException

Parameter is read when …

An error occurs.